HAL GFXMMU IRQ handler and callbacks functions migration

This section provides information about the HAL GFXMMU control functions migration.

HAL GFXMMU Callbacks functions

Title

HAL1

HAL2

Error Callback 

void HAL_GFXMMU_ErrorCallback(GFXMMU_HandleTypeDef *hgfxmmu);

void HAL_GFXMMU_ErrorCallback(hal_gfxmmu_handle_t *hgfxmmu);

HAL GFXMMU Callbacks register functions

In HAL1, the function HAL_GFXMMU_RegisterCallback is used to register various GFXMMU callbacks through a single with a specific callback ID, whereas, in HAL2, distinct functions are available to register each specific GFXMMU callback.

title

HAL1

HAL2

Register Error Callback 

HAL_GFXMMU_RegisterCallback(&gfxmmu_handle,
                         HAL_GFXMMU_ERROR_CB_ID,
                         USER_GFXMMU_ErrorCallback);

HAL_GFXMMU_RegisterErrorCallback(&gfxmmu_handle,
                                 USER_GFXMMU_ErrorCallback);

HAL GFXMMU Callbacks unregister functions

In HAL2, the unregister callback API has been removed. Instead, callbacks can be managed by re-registering the default HAL GFXMMU weak callbacks as needed.

title

HAL1

HAL2

UnRegister Error Callback 

HAL_GFXMMU_UnRegisterCallback(&gfxmmu_handle,
                              HAL_GFXMMU_ERROR_CB_ID);

HAL_GFXMMU_RegisterErrorCallback(&gfxmmu_handle,
                                 HAL_GFXMMU_ErrorCallback);

Related concept:

HAL GFXMMU IRQ handler

Note

The functions HAL_GFXMMU_IRQHandler() have been unchanged.